home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / mhs / qm200.exe / QMAIL.TXT < prev    next >
Text File  |  1993-03-31  |  15KB  |  363 lines
  1. QMAILversion 2.0           Page 6             March 31, 1993
  2.                      QMAIL (Quick Mail)
  3.                          Version 2.0
  4.                    Copyright (C) 1991,1993
  5.                 Affirmative Computer Systems
  6.  
  7. Introduction
  8.  
  9. QMail is an MHS compatible mailer designed to give you all
  10. the powerful basic features of the popular email packages in
  11. a simple to use, command line utility.  With QMail, you can
  12. send simple on-line email messages from any application or
  13. batch file or you can send full messages stored in files.
  14. You can also attach files to any mail message using
  15. wildcards or lists or simple file names as you desire.
  16.  
  17. Requirements
  18.  
  19. The only requirements for QMail is an MHS installation and
  20. imagination.  Of course, a PC of some type and some amount
  21. of memory would be helpful as well.
  22.  
  23. Installation
  24.  
  25. The only installation necessary for QMail to operate
  26. conveniently is to place the QMAIL.EXE application in the
  27. users' path somewhere.  Additional installation instructions
  28. are required for registering QMail and can be found in the
  29. section entitled registration.
  30.  
  31. There are a number of environment variables that MUST be set
  32. correctly for QMail to function.
  33.  
  34.      MV - This is the single most important environment
  35.           variable since it tells MHS and its supporting
  36.           applications where it is located.  MV should point
  37.           to the root of the MHS directory structure.  For
  38.           example MV=F:\ states that MHS is located in
  39.           F:\MHS.  If MV=F:\EMAIL then MHS would be located
  40.           in F:\EMAIL\MHS
  41.      
  42.      USR - This should be set to the MHS username for each
  43.           user.  QMail (and MHS) use this variable for
  44.           return mail addresses and for scanning the correct
  45.           mailbox.  The easiest way to ensure that this is
  46.           always set correctly is to place the line DOS SET
  47.           USR="%LOGIN_NAME" in the Novell system login
  48.           script.
  49.  
  50. Using QMail
  51.  
  52. QMail has numerous command line parameters to allow for a
  53. variety of available options.  By simply entering QMAIL, a
  54. list of the options will be presented.
  55.  
  56. Each option (or parameter) usually requires some argument to
  57. qualify the option.  For example, the "-T" parameter
  58. requires an address to make it valid.  There are five types
  59. of arguments used throughout this documentation:
  60.  
  61. {} - this is the most simplistic of all arguments.  Simply
  62.      stated, it means there are no arguments required.  For
  63.      example "-R" has no arguments.  It simply turns on the
  64.      return-receipt flag.
  65.  
  66. {Filename} - Any fully qualified filename.  This can include
  67.      full path or simple local filenames.  Wildcards may be
  68.      used in some arguments.  See the option description for
  69.      more information.
  70.  
  71. {Address} - A valid MHS address.  An MHS address follows the
  72.      format USER@HOST.  That is, you should always have the
  73.      username preceding the "@".  The HOST in this case
  74.      would be the remote MHS hub where USER is residing.  If
  75.      a HOST is not specified, the local host name will be
  76.      used.
  77.  
  78.      QMail uses a number of validation routines to verify
  79.      that these addresses are correct.  If the address is
  80.      local (on this host) then QMail checks the local host
  81.      tables to ensure that the user actually exists.  If it
  82.      is a remote user, QMail checks to ensure that the host
  83.      name is a known host.
  84.  
  85. {List} - Probably one of the most powerful features of QMail
  86.      is its ability to handle lists of information.  The
  87.      list structure is simply a comma delimited set of
  88.      information pertinent to the option.  For example,
  89.      A,B,C,D would be a list of characters.  You may also
  90.      include directives to scan files for this information.
  91.      This expands the use of the command line.  Normally,
  92.      DOS only supports about 128 characters in a single
  93.      command.  As a command line mailer, this could be very
  94.      limiting to QMail's operation.  As another example lets
  95.      look at the list A,B,@FILE1,D,@FILE2.  This tells QMAIL
  96.      to use "A", and "B" and "D" as above, however, it
  97.      should also look at the files "FILE1" and "FILE2" for
  98.      additional lists.  The structure of these files are
  99.      simply line after line of this {List} format.  In this
  100.      way, QMail is almost limitless in the amount of
  101.      information it can pass.  You can even have files that
  102.      contain lists of file names that have lists of file
  103.      names and so on...
  104.  
  105. {Text} - This is information usually enclosed in quotations.
  106.  
  107. One Important Note. Any parameters that include a space must
  108. be entirely enclosed in quotations.  Otherwise QMail may
  109. misinterpret the parameter list.
  110. For example:
  111.      -t"JOE@HOST {FAX 431-2345}"
  112.      is the correct way of using extended addressing to send
  113. a FAX (if available).
  114.      -tJOE@HOST {FAX 431-2345}
  115.      will not work.  QMail will interpret the {FAX and 431-
  116.      2345} as options since they are preceded by a space.
  117.      
  118. QMail Options
  119.  
  120. The following is a list of available options and their
  121. associated descriptions:
  122.  
  123.    Option      Brief   Req            Description
  124. -T{list}     To        Yes  This REQUIRED parameter
  125.                             indicates the recipients of
  126.                             this message.  If a host
  127.                             specification is not given in
  128.                             the address(es), the local
  129.                             host name is used.  QMail will
  130.                             validate all addresses at
  131.                             process time.
  132. -M{text}     Message   No   This is the text to include as
  133.                             the body of the message.
  134.                             Remember to enclose the text
  135.                             in quotations if it includes
  136.                             spaces.
  137. -S{text}     Subject   No   This is the text to use as the
  138.                             subject of the message.
  139.                             Remember to enclose the text
  140.                             in quotations if it includes
  141.                             spaces.
  142. -A{list}     Attach    No   If you wish to attach files to
  143.                             this message, list them here.
  144.                             You may include any normal DOS
  145.                             wildcard specifications you
  146.                             wish (ie. *.ZIP, *.EXE,
  147.                             etc...).
  148. -C{list}     Carbon    No   List all the recipients'
  149.              Copy           addresses you wish to receive
  150.                             carbon copies of this message.
  151.                             The fact that it is a "COPY"
  152.                             and not the original (as
  153.                             specified in the -T option)
  154.                             will be indicated to the
  155.                             receiver.  The list of
  156.                             recipients will also be shown.
  157. -B{list}     Blind     No   List all the recipients'
  158.              Carbon         addresses you wish to receive
  159.              Copy           blind carbon copies of this
  160.                             message.  A blind carbon copy
  161.                             will appear to be an original
  162.                             from the receiver's
  163.                             standpoint.
  164. -F{filename} Message   No   The name of the file you wish
  165.              File           to use as the body of the
  166.                             message.  Only one message
  167.                             file may be specified,
  168.                             therefore, no wildcards or
  169.                             lists can be used.  If -M is
  170.                             issues as well as -F, the text
  171.                             included in -M will precede
  172.                             the text found in this file.
  173. -${address}  From      No   This option allows you to
  174.                             specify a different sender
  175.                             than yourself when sending
  176.                             this message.  This is a
  177.                             rather touchy subject since
  178.                             you could essentially send
  179.                             false mail to users.  The only
  180.                             real purpose of this should be
  181.                             to send mail from a fictitious
  182.                             user to eliminate the
  183.                             possibility of replies.
  184.  
  185. Error Messages
  186.  
  187. QMail will return a variety of error messages to indicate a
  188. problem with the message.  The following describes the
  189. messages and how to correct the situations:
  190.  
  191. Invalid address file: {filename}
  192.      A filename was found in one of your lists that does not
  193.      exist.  This can also happen if one of your list files
  194.      contains another filename that does not exist.  Check
  195.      all your parameters and referenced files for possible
  196.      problems.
  197.      
  198. Invalid attachment file: {filename}
  199.      One of the attachments specified cannot be located.
  200.      Check all parameters and lists and referenced files for
  201.      possible problems.
  202.      
  203. Attachment file not found: {filename}
  204.      This will only result if no attachments listed can be
  205.      located.  In other words, if you try to attach *.DAT
  206.      and there are no .DAT files to be found, this message
  207.      will be returned.
  208.      
  209. Error creating attachment temp file: {filename}
  210.      You do not have correct access to the \MHS\MAIL\PARCEL
  211.      directory.  Each user must be able to write, create,
  212.      and erase to this directory as needed.  Alternatively,
  213.      there may be a DOS error (disk full or corrupted disk)
  214.      that can result in this message.
  215.      
  216. Error opening attachment temp file: {filename}
  217.      Almost an impossibility if the file gets created
  218.      correctly, however, if you disk fills up or the file
  219.      get mysteriously erased before it can be opened for
  220.      writing, this error may result.
  221.      
  222. Error creating MHS temporary file: {filename}
  223.      You do not have correct access to the \MHS\MAIL\SND
  224.      directory.  Each user must be able to write, create,
  225.      and erase to this directory as needed.  Alternately,
  226.      there may be a DOS error (disk full or corrupted) that
  227.      can result in this message.
  228.      
  229. Error opening MHS temporary file
  230.      The temporary file was created successfully but QMail
  231.      was unable to open it.  You do not have correct access
  232.      to the \MHS\MAIL\SND directory.  Each user must be able
  233.      to write, create, and erase to this directory as
  234.      needed.
  235.      
  236. Error closing MHS temporary file
  237.      Although a rarity, this was placed here for completion
  238.      sake.  It simply indicates the QMAIL was unable to
  239.      properly close the temporary file.
  240.      
  241. Error writing to temp file: {filename}
  242.      If the disk fills or there is some problem with the
  243.      temporary file, this message will result.  You may not
  244.      have correct access to \MHS\MAIL\SND.  All users should
  245.      have create, write, and erase access to this directory.
  246.      
  247. Error copying attachment: {filename}
  248.      An error occurred while trying to copy an attachment
  249.      file to \MHS\MAIL\PARCEL.  This can result if the file
  250.      is open by another user, the disk is full, or you do
  251.      not have correct access to \MHS\MAIL\PARCEL.  All users
  252.      should have create, write and erase access to this
  253.      directory.
  254.      
  255. Missing required parameter
  256.      A parameter that is required for correct processing of
  257.      your mail was missing.  The message cannot be further
  258.      processed.  An example would be the "-T" parameter
  259.      since without it, there would be no recipient.
  260.      
  261. Invalid host: {hostname}
  262.      QMail performs various validation routines on all
  263.      addresses.  If an address is not local (the host name
  264.      is not the local MHS host name), then the internal MHS
  265.      host table is checked.  If no host of this name is
  266.      defined, this message will be returned.  Check the
  267.      address again and make sure the host has been defined.
  268.      
  269. No such user at this host: {username}
  270.      QMail performs various validation routines on all
  271.      addresses.  If an address is local (the host name is
  272.      the local MHS host name) then the internal MHS user
  273.      list is checked.  If no user of this name is defined,
  274.      this message will be returned.  Check the address again
  275.      and verify that the hosts have been added.  Also, make
  276.      sure the user is properly defined by MHS
  277.      
  278. Error canceling message.
  279.      If an error occurs during mail processing, a cleanup is
  280.      done of all temporary files.  If, for some reason,
  281.      QMail is unable to delete one of these files, this
  282.      error will result.
  283.      
  284. Missing or invalid message file: {filename}
  285.      If a message file is specified with the "-F" option,
  286.      and the file cannot be found, this error will result.
  287.      It may also result if QMail cannot open the file
  288.      correctly.
  289.  
  290. Getting Help
  291.  
  292. You may contact Affirmative Computer Systems by calling
  293. (614)-431-8943 or by sending MHS email to SUPPORT@AFFIRM.
  294. The hub phone number is (614)-431-0122.  You may also send
  295. mail via Compuserver or Internet by mailing to
  296. support@affirm.mhs.compuserve.com.
  297.  
  298. Credits
  299.  
  300. MHS is copyright Novell Inc.
  301.  
  302. Registration
  303.  
  304. QMail is not free.  It is being distributed using the
  305. Shareware concept that allows you to try the program before
  306. you purchase it.  QMail in its unregistered form will pause
  307. for keyboard input each time it is executed.  To eliminate
  308. this restriction, follow the registration instructions
  309. below.
  310.  
  311. Registration Instructions
  312.  
  313. To register QMail, fill out the following form and send it
  314. with a check or P.O. to: Affirmative Computer Systems
  315.                          2097 Brittany Road
  316.                          Columbus, Ohio 43229
  317.  
  318. You will receive a passcode that is keyed to your MHS host
  319. name, therefore IT IS IMPORTANT TO INCLUDE YOUR HOST NAME IN
  320. THE FORM.  Once you receive your passcode, simply execute
  321.  
  322.      QMAIL -!{passcode}
  323. replacing the "{passcode}" with the one you will be given.
  324. ex:
  325.      QMAIL -!1234567890
  326. Would register QMail with the passcode 1234567890
  327.  
  328. Please note that passcodes will not be sent until a check is
  329. received.  P.O.s can dramatically extend the processing time
  330. before you get your passcode.
  331.  
  332.     Item             Description         Quant  Price/  Total
  333.                                           ity     ea
  334. QMail 2.x      MHS command line email           $49.00  
  335. QMail 2.x      For users of version 1.x         $10.00  
  336. (upgrade       only (please include
  337. only)          original passcode)
  338.                                     Ohio residents add  
  339.                                  appropriate sales tax
  340.                                                  Total  
  341.  
  342.  
  343. My MHS hub name is _______________________
  344.  
  345.  
  346. Please send my passcode via:
  347.  
  348. [   ]  U.S. Mail
  349.      Address:
  350. _______________________________________________________
  351.  
  352.  
  353. _______________________________________________________
  354.  
  355.  
  356. _______________________________________________________
  357.  
  358.  
  359. [  ] Internet mail.  My address is: ________________________
  360.  
  361.  
  362. [  ] Compuserve mail.  My address is: ______________________
  363.